home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / util2 / dksound2.lha / DarkSound / DarkSound.eng.doc < prev    next >
Text File  |  1995-08-19  |  9KB  |  264 lines
  1. *****************************************
  2. *        `DarkSound'  V 2.1        *
  3. *       An OriginalWare release by      *
  4. *    Troglobyte/Darkness © 1994    *
  5. *****************************************
  6.  
  7. Contents
  8. ========
  9.  
  10. 1. Introduction
  11. 2. Instructions
  12. 3. ToolTypes
  13. 4. Errors and solutions
  14. 5. History
  15. 6. What is OriginalWare?
  16. 7. Thanks
  17. 8. Credits
  18.  
  19.  
  20. 1. Introduction
  21. ===============
  22.  
  23. Are  you  tired  of  hearing the same sound alert each time the Amiga warns
  24. you?
  25.  
  26. DarkSound  is the answer to your prayers!  It will randomly choose a sample
  27. each time you boot your machine.Now, your errors won't sound the same.#8>)
  28.  
  29. DarkSound  will  play  a  random  Start sample anytime you load it and will
  30. select another random Alert sample to be used as the system sound Alert.
  31.  
  32. DarkSound  is  very  easy  to  install,  and  once installed you can't live
  33. without  it,  and  with  the  correct sample you can always surprise others
  34. Amiga and PC users, you even can surprise yourself.
  35.  
  36.  
  37. 2. Instructions
  38. ===============
  39.  
  40. To  install  DarkSound just drag his icon to the `DH0:WBStartup' drawer, or
  41. copy  the  `DarkSound'  and `DarkSound.info' to you `SYS:WBStartup' drawer.
  42. Then  configure  the ToolTypes of the icon (for more info look at Section 3
  43. of this instructions:  3.  ToolTypes)
  44.  
  45. DarkSound  (optionally)  will play another sample each time you run it; and
  46. as DarkSound must be installed in your `WBStartup' drawer, this sample will
  47. play  anytime  you init your WorkBench, you can use this sample to warn you
  48. that your Workbench finished loading and your Amiga is ready to be enjoyed.
  49. After  this DarkSound will select another random Alert sample to be used as
  50. the  system sound Alert and then will exit.  Both samples are selected from
  51. different sound lists that you must define in the DarkSound icon ToolTypes.
  52. I  recommend  to  use  longer sounds as Start samples and shorter sounds as
  53. Alert samples, but you can use whatever you want.
  54.  
  55. The  sound  samples  provided  are  only  for  test, use your own favourite
  56. sounds.
  57.  
  58. You  can use the `DH0:Prefs/Sound' preferences editor, to select the volume
  59. of  the  samples  and  if  you want a screen flash together with the System
  60. Alert sample.
  61.  
  62. When  DarkSound  is  executed  it  change  your  sound  prefs  and exit, so
  63. DarkSound don't waste nothing of your precious CPU time and memory.
  64.  
  65. DarkSound  only edit your RAM:  configuration (RAM:ENV/Sys/Sound.Prefs), so
  66. DarkSound never WRITE nothing to your Hard Disk.
  67.  
  68. All this is more simple than it sounds #8>) so just check it.
  69.  
  70.  
  71. 3. ToolTypes
  72. ============
  73.  
  74. Now you can/must configure DarkSound with the icon ToolTypes.
  75.  
  76. To  edit configuration, click once the DarkSound icon and press right mouse
  77. button  to  select  in the Workbench menu `Icons' the `Information' option,
  78. you  can  select it pressing at the same time the right `Amiga' key and the
  79. `I' key.Then a window will appear to easily write your own configuration.
  80.  
  81. There are 2 ToolTypes to select the Start sample :
  82.  
  83.  ToolType 1 : Start_Name=dh0:Sounds/Sample00.Iff
  84. With  this  you  select  the  path and name of the Start sample you want to
  85. play.   Remember  that  all the samples must have the same name, and a `00'
  86. string anywhere in the name of the sample, but the Sample00 isn't used.
  87.  Examples :
  88. dh1:Sounds/Sound00    - OK
  89. SYS:Sample.00.IFF    - OK
  90. DH0:Sound13        - Bad : the number must be 00 (Sound00, OK)
  91. dh1:Sound000        - Bad : the number must be 2 digit only (Sound00)
  92.  
  93.  ToolType 2 : Start_Number=03
  94. This  is  the number of samples.  If the number is `00' the Start Sample is
  95. OFF.
  96.  Example :
  97. With this ToolTypes,
  98.  START_NAME  =dh0:Sounds/Sample00.Iff
  99.  START_NUMBER=03
  100. you must have the samples :
  101.  dh0:Sounds/Sample01.Iff
  102.  dh0:Sounds/Sample02.Iff
  103.  dh0:Sounds/Sample03.Iff
  104.  
  105. There  are  other  2  ToolTypes  to  select  the  System Alert sample, this
  106. ToolTypes  are  used  like  the  previous 2 ToolTypes, you can use the same
  107. samples or other samples.
  108.  
  109.  ToolType 3 : Alert_Name  =dh0:Sounds/Alert00.Iff
  110.  
  111.  ToolType 4 : Alert_Number=07
  112.  
  113. The other ToolTypes are standard Workbench ToolTypes, and usually you don't
  114. need to change them; if you don't know what they do, don't touch them.
  115.  
  116.  ToolType 5 : StartPriority=0
  117. This  ToolType  is  used  to  select  in which order WBStartup programs are
  118. loaded, if you use the Start sample I recomend to load DarkSound the last.
  119.  
  120.  ToolType 6 : DoNotWait
  121. This ToolType tell the system Do Not Wait to this program to finish, so the
  122. system continue loading other programs while executing DarkSound.
  123.  
  124.  
  125. 4. Errors and solutions
  126. =======================
  127. If `DarkSound' found any error will open a window with the problem, it will
  128. help you to check out and correct your problems.
  129.  
  130. WorkBench 2.1 or later required by DarkSound to work (if you have KickStart
  131. 1.x consider DarkSound another good reason to upgrade your Amiga).
  132.  
  133. DarkSound  must  be copied in the `SYS:WbStartup' drawer, you must copy the
  134. program  `DarkSound'  and the icon `DarkSound.info' with this names, if you
  135. rename this files, the program won't work.
  136.  
  137. The  file  `RAM:ENV/Sys/Sound.Prefs' is required, if you don't have it, use
  138. the `SYS:Prefs/Sound' program to create it and select your preferences.
  139.  
  140. Remember  that  your old `sound.prefs' sample selections are overwritten by
  141. DarkSound  in  RAM:   but  are  still  in your hard disk, so if one day you
  142. decide   to  stop  using  DarkSound,  your  original  preferences  will  be
  143. automatically used again.
  144.  
  145. If you get the system error `Sound.Prefs is a BAD Prefs File', then one
  146. of your sounds isn't a standard IFF sample, check them with a sound program.
  147. There can be only 100 samples, but this must not be a problem (I think).
  148.  
  149. If you have any other problem or doubt, contact me (address is at the end)
  150.  
  151.  
  152. 5. History
  153. ==========
  154.  
  155. Version 1.1 ( 8-Apr-94) :
  156.   - First released version.
  157.  
  158. Version 1.2 (20-May-94) :
  159.  - Play the LAST sound in the list when run it to alert you that your
  160.    WorkBench is loaded, (you can use a long sample like `Commodore is
  161.    dead but your Amiga is still the best computer  and is ready to be
  162.    used' and use smaller samples as alerts) and choose another sample
  163.    randomly for the WB Sound Alert.
  164.  - Improved Docs.
  165.  - MagicWB Icon added.
  166.  - More Samples included (but not good enough yet). 
  167.  
  168. Version 1.3 (20-Sep-94) :
  169.  - If you use it from CLI will display errors.
  170.  - Code optimized for future versions.
  171.  - FIDO address added :-)
  172.  
  173. Version 2.0 (10-Nov-94) :
  174.  - Major update.
  175.  - Different sound lists for Start and Alert samples.
  176.  - Added ToolTypes for configuration.
  177.  - Docs in AmigaGuide format.
  178.  - Spanish docs added.
  179.  
  180. Version 2.1 (25-Nov-94) :
  181.  - Open a window with the errors found.
  182.  
  183.  
  184. 6. What is OriginalWare ?
  185. =========================
  186.  
  187. This  utility  is OriginalWare.That means if you like this program you must
  188. buy  an  original  Amiga program or game or send the money to the author of
  189. any ShareWare program or game you are using often.
  190.  
  191. There  are  lots  of  great Amiga software like `DiskMaster', `Hired Guns',
  192. `Syndicate',   `Goal',  `Vital  Light',  `Pinball  Fantasies',  `Stardust',
  193. `Elfmania' and a lot more that you won't never regret to spend your money.
  194.  
  195. If  you do this you support the Amiga, and if you support AMIGA you support
  196. US.
  197.  
  198. OriginalWare  is  a  new  concept  (I  think  so) conceived by me; for more
  199. information or suggestions about OriginalWare, contact me, please.
  200.  
  201. Support OriginalWare software and you will get more and better software.
  202.  
  203. DarkSound could be included in any PD compilation, except some samples that
  204. could have different copyrights.
  205. Fred Fish and Aminet collections are specifically allowed to use it.
  206.  
  207.  To Magazines :
  208. You can give away this utility on your coverdisk, but please send me a copy
  209. of the magazine.
  210.  
  211.  
  212. 7. Thanks to:
  213. =============
  214.  
  215. Amiga Vice for the idea and the ßeta testing.
  216. Hipnooxis for ALL the help and show me to use and respect the Amiga O.S.
  217. Binary for the help with the first docs and much more things.
  218. Knackosoft/TRSI for being my best `invisible' friend.
  219. Alberto Sanchez and David Santamaria for some help in this project.
  220.  
  221. Everybody responsible of the nice samples.
  222.  
  223. To the new owner of the Amiga... whoever it will be.
  224.  
  225. To all the Amiga users worldwide for their trust in the Amiga.
  226.  
  227. To you for read this and for use DarkSound (because you use it...or not?)
  228.  
  229. To the Amiga...
  230.  
  231.  
  232. 8. Credits
  233. ==========
  234.  
  235. Code by Troglobyte/Darkness with some help by Hipnooxis/Darkness.
  236. Idea by Amiga Vice/Darkness.
  237. The authors of the samples provided.
  238.  
  239. Send  us  JOB  offers,  BUGS,  comments,  improvements, ideas, suggestions,
  240. disks,  mags,  advices,  complains,  nice  PD  stuff  (like Demos, Games or
  241. Utilities),  and your favourite IFF Sounds samples to include in future and
  242. better versions of this utility :
  243.  
  244.             M. Martin Vivaldi
  245.              Av. America 60
  246.               Madrid 28028
  247.                  SPAIN
  248.  
  249. Or NetMail me at :
  250.  
  251.  Internet : bitabit@servicom.es        (Faster and safer)
  252.  
  253.  FidoNet  : 2:341/28.55        Manuel Martin
  254.  
  255.  AmigaNet : 39:192/2.55        Manuel Martin
  256.  
  257.  
  258. Coders, musicians and graphicians are available for COMPUTER or CONSOLES
  259. quality works at the above address.
  260.          
  261.  
  262.  
  263.  
  264.